#----------------------------------------------------------------------------
# Configure the behaviour when a domain exits. There are three 'reasons'
# for a domain to stop: poweroff, reboot, and crash. For each of these you
-# may specify "destroy", meaning that the domain is cleaned up as normal,
-# "restart", meaning that a new domain is started in place of the old one, or
-# "preserve", meaning that no clean-up is done until the domain is manually
-# destroyed (using xm destroy, for example).
+# may specify:
+#
+# "destroy", meaning that the domain is cleaned up as normal;
+# "restart", meaning that a new domain is started in place of the old
+# one;
+# "preserve", meaning that no clean-up is done until the domain is
+# manually destroyed (using xm destroy, for example); or
+# "rename-restart", meaning that the old domain is not cleaned up, but is
+# renamed and a new domain started in its place.
#
# The default is
#
#----------------------------------------------------------------------------
# Configure the behaviour when a domain exits. There are three 'reasons'
# for a domain to stop: poweroff, reboot, and crash. For each of these you
-# may specify "destroy", meaning that the domain is cleaned up as normal,
-# "restart", meaning that a new domain is started in place of the old one, or
-# "preserve", meaning that no clean-up is done until the domain is manually
-# destroyed (using xm destroy, for example).
+# may specify:
+#
+# "destroy", meaning that the domain is cleaned up as normal;
+# "restart", meaning that a new domain is started in place of the old
+# one;
+# "preserve", meaning that no clean-up is done until the domain is
+# manually destroyed (using xm destroy, for example); or
+# "rename-restart", meaning that the old domain is not cleaned up, but is
+# renamed and a new domain started in its place.
#
# The default is
#
#----------------------------------------------------------------------------
# Configure the behaviour when a domain exits. There are three 'reasons'
# for a domain to stop: poweroff, reboot, and crash. For each of these you
-# may specify "destroy", meaning that the domain is cleaned up as normal,
-# "restart", meaning that a new domain is started in place of the old one, or
-# "preserve", meaning that no clean-up is done until the domain is manually
-# destroyed (using xm destroy, for example).
+# may specify:
+#
+# "destroy", meaning that the domain is cleaned up as normal;
+# "restart", meaning that a new domain is started in place of the old
+# one;
+# "preserve", meaning that no clean-up is done until the domain is
+# manually destroyed (using xm destroy, for example); or
+# "rename-restart", meaning that the old domain is not cleaned up, but is
+# renamed and a new domain started in its place.
#
# The default is
#
#----------------------------------------------------------------------------
# Configure the behaviour when a domain exits. There are three 'reasons'
# for a domain to stop: poweroff, reboot, and crash. For each of these you
-# may specify "destroy", meaning that the domain is cleaned up as normal,
-# "restart", meaning that a new domain is started in place of the old one, or
-# "preserve", meaning that no clean-up is done until the domain is manually
-# destroyed (using xm destroy, for example).
+# may specify:
+#
+# "destroy", meaning that the domain is cleaned up as normal;
+# "restart", meaning that a new domain is started in place of the old
+# one;
+# "preserve", meaning that no clean-up is done until the domain is
+# manually destroyed (using xm destroy, for example); or
+# "rename-restart", meaning that the old domain is not cleaned up, but is
+# renamed and a new domain started in its place.
#
# The default is
#
restart_modes = [
"restart",
"destroy",
- "preserve"
+ "preserve",
+ "rename-restart"
]
STATE_VM_OK = "ok"
restart_reason = 'crash'
elif xeninfo['shutdown']:
- reason = shutdown_reason(xeninfo['shutdown_reason'])
+ if self.readDom('xend/shutdown'):
+ # We've seen this shutdown already, but we are preserving
+ # the domain for debugging. Leave it alone.
+ pass
+ else:
+ reason = shutdown_reason(xeninfo['shutdown_reason'])
- log.info('Domain has shutdown: name=%s id=%d reason=%s.',
- self.info['name'], self.domid, reason)
+ log.info('Domain has shutdown: name=%s id=%d reason=%s.',
+ self.info['name'], self.domid, reason)
- self.clearRestart()
+ self.clearRestart()
- if reason == 'suspend':
- self.state_set(STATE_VM_SUSPENDED)
- # Don't destroy the domain. XendCheckpoint will do this
- # once it has finished.
- elif reason in ['poweroff', 'reboot']:
- restart_reason = reason
- else:
- self.destroy()
+ if reason == 'suspend':
+ self.state_set(STATE_VM_SUSPENDED)
+ # Don't destroy the domain. XendCheckpoint will do
+ # this once it has finished.
+ elif reason in ['poweroff', 'reboot']:
+ restart_reason = reason
+ else:
+ self.destroy()
else:
# Domain is alive. If we are shutting it down, then check
self.storeDom('xend/shutdown_start_time', time.time())
+ ## private:
+
def clearRestart(self):
self.removeDom("xend/shutdown_start_time")
def maybeRestart(self, reason):
# Dispatch to the correct method based upon the configured on_{reason}
# behaviour.
- {"destroy" : self.destroy,
- "restart" : self.restart,
- "preserve" : self.preserve}[self.info['on_' + reason]]()
+ {"destroy" : self.destroy,
+ "restart" : self.restart,
+ "preserve" : self.preserve,
+ "rename-restart" : self.renameRestart}[self.info['on_' + reason]]()
def preserve(self):
self.domid)
+ def renameRestart(self):
+ self.restart(True)
+
+
def dumpCore(self):
"""Create a core dump for this domain. Nothrow guarantee."""
self.console_channel = None
+ ## public:
+
def setConsoleRef(self, ref):
self.console_mfn = ref
self.storeDom("console/ring-ref", ref)
try:
self.dompath = DOMROOT + str(self.domid)
+ # Ensure that the domain entry is clean. This prevents a stale
+ # shutdown_start_time from killing the domain, for example.
+ self.removeDom()
+
self.initDomain()
self.construct_image()
self.configure()
log.exception("XendDomainInfo.destroy: xc.domain_destroy failed.")
+ ## private:
+
def is_terminated(self):
"""Check if a domain has been terminated.
"""
log.error("Recovering from above exception.")
self.storeDom(path, ret.port1)
return ret
-
+
def create_channel(self):
"""Create the channels to the domain.
"""
if self.image:
self.image.createDeviceModel()
+
+ ## public:
+
def device_create(self, dev_config):
"""Create a new device.
self.configureDevice(deviceClass, devid, dev_config)
- def restart_needed(self, reason):
- """Determine if the vm needs to be restarted when shutdown
- for the given reason.
-
- @param reason: shutdown reason
- @return True if needs restart, False otherwise
- """
- if self.info['restart_mode'] == RESTART_NEVER:
- return False
- if self.info['restart_mode'] == RESTART_ALWAYS:
- return True
- if self.info['restart_mode'] == RESTART_ONREBOOT:
- return reason == 'reboot'
- return False
-
+ ## private:
def restart_check(self):
"""Check if domain restart is OK.
self.restart_count += 1
- def restart(self):
- """Restart the domain after it has exited. """
+ def restart(self, rename = False):
+ """Restart the domain after it has exited.
+
+ @param rename True if the old domain is to be renamed and preserved,
+ False if it is to be destroyed.
+ """
# self.restart_check()
config = self.sxpr()
- self.cleanupDomain()
-
if self.readVm('xend/restart_in_progress'):
log.error('Xend failed during restart of domain %d. '
'Refusing to restart to avoid loops.',
self.writeVm('xend/restart_in_progress', 'True')
try:
- self.destroy()
+ if rename:
+ self.preserveShutdownDomain()
+ else:
+ self.cleanupDomain()
+ self.destroy()
+
try:
xd = get_component('xen.xend.XendDomain')
xd.domain_unpause(xd.domain_create(config).getDomid())
# self.exportToDB()
+ def preserveShutdownDomain(self):
+ """Preserve a domain that has been shut down, by giving it a new UUID,
+ cloning the VM details, and giving it a new name. This allows us to
+ keep this domain for debugging, but restart a new one in its place
+ preserving the restart semantics (name and UUID preserved).
+ """
+
+ new_name = self.generateShutdownName()
+ new_uuid = getUuid()
+ log.info("Renaming dead domain %s (%d, %s) to %s (%s).",
+ self.info['name'], self.domid, self.uuid, new_name, new_uuid)
+ self.release_devices()
+ self.info['name'] = new_name
+ self.uuid = new_uuid
+ self.vmpath = VMROOT + new_uuid
+ self.storeVmDetails()
+ self.storeDom('vm', self.vmpath)
+ self.storeDom('xend/shutdown', 'True')
+
+
+ def generateShutdownName(self):
+ n = 1
+ while True:
+ name = "%s-%d" % (self.info['name'], n)
+ try:
+ self.check_name(name)
+ return name
+ except VmError:
+ n += 1
+
+
def configure_bootloader(self):
if not self.info['bootloader']:
return
gopts.var('restart', val='onreboot|always|never',
fn=set_value, default=None,
- use="""Whether the domain should be restarted on exit.
+ use="""Deprecated. Use on_poweroff, on_reboot, and on_crash
+ instead.
+
+ Whether the domain should be restarted on exit.
- onreboot: restart on exit with shutdown code reboot
- always: always restart on exit, ignore exit code
- never: never restart on exit, ignore exit code""")
+gopts.var('on_poweroff', val='destroy|restart|preserve|rename-restart',
+ fn=set_value, default=None,
+ use="""Behaviour when a domain exits with reason 'poweroff'.
+ - destroy: the domain is cleaned up as normal;
+ - restart: a new domain is started in place of the old one;
+ - preserve: no clean-up is done until the domain is manually
+ destroyed (using xm destroy, for example);
+ - rename-restart: the old domain is not cleaned up, but is
+ renamed and a new domain started in its place.
+ """)
+
+gopts.var('on_reboot', val='destroy|restart|preserve|rename-restart',
+ fn=set_value, default=None,
+ use="""Behaviour when a domain exits with reason 'reboot'.
+ - destroy: the domain is cleaned up as normal;
+ - restart: a new domain is started in place of the old one;
+ - preserve: no clean-up is done until the domain is manually
+ destroyed (using xm destroy, for example);
+ - rename-restart: the old domain is not cleaned up, but is
+ renamed and a new domain started in its place.
+ """)
+
+gopts.var('on_crash', val='destroy|restart|preserve|rename-restart',
+ fn=set_value, default=None,
+ use="""Behaviour when a domain exits with reason 'crash'.
+ - destroy: the domain is cleaned up as normal;
+ - restart: a new domain is started in place of the old one;
+ - preserve: no clean-up is done until the domain is manually
+ destroyed (using xm destroy, for example);
+ - rename-restart: the old domain is not cleaned up, but is
+ renamed and a new domain started in its place.
+ """)
+
gopts.var('blkif', val='no|yes',
fn=set_bool, default=0,
use="Make the domain a block device backend.")
config.append(['backend', ['tpmif']])
if vals.restart:
config.append(['restart', vals.restart])
+ if vals.on_poweroff:
+ config.append(['on_poweroff', vals.on_poweroff])
+ if vals.on_reboot:
+ config.append(['on_reboot', vals.on_reboot])
+ if vals.on_crash:
+ config.append(['on_crash', vals.on_crash])
if vals.bootloader:
config.append(['bootloader', vals.bootloader])
projects / xen.git / commitdiff